home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / WINDOWS / ORATOR.ARJ / ORATDOC.TXT < prev    next >
Text File  |  1992-08-05  |  13KB  |  437 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                     Orator V1.0 (Beta)
  7.  
  8.                  (c) 1992 by Nick Dyer, EvaWare UK
  9.  
  10.  
  11. Copyright
  12. Orator Copyright (c) 1992 by Nick Dyer of EvaWare UK is
  13. being distributed as Shareware. Under this concept you
  14. may use the SHAREWARE (unregistered) version for 30 days
  15. for evaluation after which you must register your copy or
  16. cease to use it.
  17.  
  18.  
  19. Distribution
  20. You are encouraged to distribute Orator  provided that
  21. all the files contained in the archive are distributed in
  22. their original and unregistered state. You are not under
  23. any circumstances permitted to distribute a registered
  24. copy of Orator.
  25.  
  26.  
  27.  
  28. Introduction
  29. Orator V1.0 beta is the first version of a new Qwk mail
  30. packet reader for Windows V3.x. This programming project
  31. is the first undertaken by myself both in the PC market
  32. and in Visual Basic (The language the system was
  33. written in).
  34.  
  35. It marks the beginning of a new range of products inc BBS
  36. doors etc written by myself and marketed under the
  37. company name of EvaWare UK.
  38.  
  39. I hope that you find it as much fun to use as I found to
  40. write. Compared to the work that I have been doing before
  41. this really was an interesting program to write. If you
  42. find Orator to be useful then please be honest and
  43. register this copy. There is an order form included with
  44. this Archive. See Registration below.
  45.  
  46. Orator V1.0 beta features :-
  47.  
  48.      Unlimited Conference Quantity Handling.
  49.  
  50.      Unique Conference Sorting and Search (No More
  51. hunting thru lists)
  52.  
  53.      Ansi Viewer
  54.  
  55.      Tagline Theft
  56.  
  57.      Remote Qmail Door Configuration
  58.  
  59.      Swedish Language Version Available
  60.  
  61. plus lots more.
  62.  
  63. The unregistered version of Orator V1.0 (beta) is fully
  64. functional apart from taglines. If Orator is not
  65. registered then the following appears at the bottom of
  66. all your Mail Messages:
  67.  
  68.  
  69. _ Orator V1.0 _  [Windows Qwk Reader Unregistered
  70. Evaluation Copy]
  71.  
  72.  
  73. In addition to this there is a screen that appears every
  74. time Orator is started prompting you to register the
  75. product. This can be eliminated by registration.
  76.  
  77.  
  78. Included in the archive is a small program called
  79. ORATVIEW.EXE. This is the program used together with its
  80. PIF file to view files in ANSI format. I myself would
  81. confess that this program requires a little bit of work
  82. carried out on it and it will be one of the first items
  83. to receive attention in the next version.
  84.  
  85.  
  86.  
  87.  
  88.  
  89. Warranty
  90. Although rigorous testing has been carried out you should
  91. bear in mind that this product is still out as a Beta
  92. version. Nothing can be guaranteed. Your comments and
  93. problems are welcomed as it is only through user
  94. participation that this product can be made one of the
  95. greats. See contacting the Author below.
  96.  
  97.  
  98. Installation
  99. Copy the zip file to a subdirectory on your hard drive
  100. and 'unzip' it using Pkunzip by PKware.
  101.  
  102. Add the program Orator.exe to your Windows program
  103. groups. (See Windows documentation for a description on
  104. adding program items)
  105.  
  106. When you first run Orator it will inform you that no
  107. Configuration file has been found and that it is about to
  108. create one. Click on OK and proceed to Orator
  109. Configuration below. Note Orator stops after this initial
  110. configuration and must be restarted after configuration
  111. has been completed.
  112.  
  113.  
  114.  
  115. Orator Configuration
  116. A dialog box reveals the following fields to be
  117. completed. Note Orator attempts to build defaults into
  118. the fields if this is the first time you are running
  119. Orator. Make your changes as required and press (ENTER)
  120. or click on OK
  121.  
  122. Default QWK Path
  123. Enter the full path name including drive name for where
  124. Orator can find your QWK packets.
  125.  
  126. Default REP Path
  127. Enter the full path name including drive name for where
  128. Orator Can find and should place any of your REPly
  129. (.REP)files.
  130.  
  131. PKunzip (inc Path)
  132. Supply here the full command including path and drive
  133. name for your chosen archiver extract command. Use %1 to
  134. represent the archive name and %2 to represent the path
  135. for the Work files eg
  136.  
  137.           C:\PKZIP\PKUNZIP %1 %2
  138.  
  139. tells Orator that the command PKUNZIP is in library PKZIP
  140. on Hard Disk C. When actually unzipping something the
  141. value of %1 is replaced with the name of the Archive to
  142. be 'unzipped' and %2 is replaced with the path to place
  143. all the files extracted into.
  144.  
  145.  
  146. PKZip (Inc Path)
  147. As above but instead give details for the Archiver
  148. Archive Command. %1 will be the Archive file to be
  149. created and %2 will be the files inc path to be added to
  150. the archive.
  151.  
  152. Signature File
  153. Is not obligatory however the contents of this text file
  154. are appended to all your replies before any tagline. Such
  155. a file might contain your name and USENET address for
  156. example.
  157.  
  158.  
  159.  
  160.  
  161. Orator Menu/Commands
  162.  
  163. File
  164. This menu is used to Open/Close/Delete packets, Configure
  165. Orator or exit Orator.
  166.  
  167. Window
  168. Is only active when a packet is open. This menu is
  169. otherwise disabled. Submenus to this menu are only
  170. enabled if the relevant information is available. For
  171. example the Bulletins menu won't be enabled if there are
  172. no bulletins included in the packet you just opened.
  173.  
  174. Welcome - Uses ORATVIEW to show the contents of the
  175. Welcome File
  176.  
  177. Session - Uses ORATVIEW to show the contents of the
  178. Session.TXT
  179.  
  180. Messages - Starts a new form to handle the reading of
  181. Mail See Below
  182.  
  183. Replies - Starts a new form to Enter/Delete replies
  184.  
  185. Bulletins - Uses ORATVIEW to read any Bulletins
  186.  
  187. News - Uses ORATVIEW to read any BBS News included.
  188.  
  189. Files - Uses ORATVIEW to view the NEWFILES.DAT file.
  190.  
  191. Services - To read any BBS services with ORATVIEW
  192.  
  193. Goodbye - Uses ORATVIEW to read any Goodbye file
  194.  
  195.  
  196.  
  197. Door
  198. Like Window is only active if a packet is open. At the
  199. present one can only configure Qmail doors remotely with
  200. this however future versions of Orator will definitely
  201. include remote configuring of other door types like
  202. MarkMail, RoseMail and Kmail to name but just a few.
  203. Clicking on Qmail reveals the following menu
  204.  
  205.  
  206. Add a Conference
  207. To choose a new conference for future mail downloading.
  208.  
  209. Drop a Conference
  210. Allows you to select a conference to be dropped from
  211. future mail scans.
  212.  
  213. Reset a Conference
  214. To select a conference and either set it's message
  215. pointer to a specific message number to begin future mail
  216. scans from or set the pointer to the highest message in
  217. that conference. You can also state a number of messages
  218. short of the highest that scanning is to begin. A dialog
  219. box appears and asks you for the number of messages you
  220. would like the pointer to be set to short of the highest
  221. message in the conference. Blank means leave the pointer
  222. at highest for conference.
  223.  
  224. Set PCBoard City.
  225. For those Qmail doors on PCBoard systems this allows you
  226. to set the City field in your user profile on the board.
  227.  
  228. Business Phone
  229. For those Qmail doors on PCBoard systems this allows you
  230. to set the Business phone number field in your user
  231. profile on the board.
  232.  
  233. Home Phone
  234. For those Qmail doors on PCBoard systems this allows you
  235. to set the home phone number field in your user profile
  236. on the board.
  237.  
  238. PCBoard Page Length
  239. For those Qmail doors on PCBoard systems this allows you
  240. to set the page length in lines in your user profile on
  241. the board.
  242.  
  243. User Password
  244. Allows you to change your password on the BBS remotely.
  245. Remember it wont be valid until after your mail packet is
  246. uploaded.
  247.  
  248.  
  249. Set Door Protocol
  250. Allows you to change the protocol used by the door to
  251. upload and download your mail.
  252.  
  253.  
  254.  
  255.  
  256.  
  257. Reading Mail
  258. Clicking on the Messages item in the Window Bar menu
  259. launches a new form for the reading of conferences
  260. containing mail. The form contains the following
  261. controls:
  262.  
  263. Next
  264. Shows the next message in the current conference. The
  265. next conference is automatically opened and viewed if you
  266. are already reading the last message in the current
  267. conference.
  268.  
  269. Prev
  270. Shows the previous message. Note if you are already
  271. reading the first message in the conference then the
  272. previous conference is NOT automatically backtracked to.
  273.  
  274. Print
  275. Prints the current message on the Windows 3.x default
  276. printer.
  277.  
  278. List
  279. Lists a summary of all the messages in the current
  280. conference. You can then choose from this list a message
  281. at random that you wish to read.
  282.  
  283. Steal
  284. Orator will attempt to steal the tagline from the current
  285. message and will allow you to view it (/amend it) before
  286. adding it to its database called Taglines.ORA. Taglines
  287. can also be stolen from the middle of messages as follows
  288.  
  289. 1 - Editing the TAGLINES.ORA file with the Windows
  290. NotePad
  291.  
  292. 2 - Marking the message part containing the Tagline(s)
  293.  
  294. 3 - Cut the marked text
  295.  
  296. 4 - Paste the marked text at the end of the Taglines.ORA
  297.  
  298.  
  299. Search
  300. Allows you to search the message base for messages
  301. containing a text sample given by you. The messages found
  302. are stored under the active conferences for you to be
  303. able to read them. The current conference is
  304. automatically dropped and the found messages are shown.
  305. See the on-line help for more information. See also
  306. Conference Hopping below.
  307.  
  308. Reply
  309. To enter a reply to the current message.
  310.  
  311. Confer
  312. See Conference Hopping below.
  313.  
  314. Cancel
  315. Quit reading Mail
  316.  
  317.  
  318.  
  319. Conference Hopping
  320.  
  321. Either by pressing the Confer button while reading
  322. messages or by pressing the 3D conference control whilst
  323. entering a Reply launches a form for selecting
  324. conferences. The form is divided into two main parts.
  325.  
  326.      1 - A list box called Numerical Conference Groups
  327.      2 - Group contents
  328.  
  329. a search button is also on the form.
  330.  
  331. Numerical Conference Groups
  332. Shown here are all the conferences available on the BBS
  333. where this packet was downloaded divided into numerical
  334. groups of 250 conferences.
  335.  
  336. Show also in the first position is an Active group which
  337. contains a summary of all conferences containing
  338. messages. You can select a certain conference group by
  339. positioning the mouse over the group title and clicking
  340. the button. If you launched this form by pressing the
  341. Confer button whilst reading mail then this list box is
  342. disabled as you may only select conferences from the
  343. active section.
  344.  
  345. Group Contents
  346. Shown here is the contents of the numerical (or active)
  347. group you selected in the above List Box. You can then
  348. choose a conference to enter your reply or read messages
  349. in by finding it in the list and selecting it and
  350. clicking your mouse button.
  351.  
  352. Search Facility
  353. Search facility prompts for a text sample to find a
  354. conference. All conference groups are searched but only
  355. the first match is shown.
  356.  
  357.  
  358. Registration
  359.  
  360. Orator Copyright (c) 1992 by Nick Dyer of EvaWare UK is
  361. being distributed as Shareware. Under this concept you
  362. may use the SHAREWARE (unregistered) version for 30 days
  363. for evaluation after which you must register your copy or
  364. cease to use it.
  365.  
  366. To register send a cheque or money order for 15.00 pounds
  367. sterling (17.50 pounds sterling if you live outside UK or
  368. Eire) to
  369.  
  370. Nick Dyer
  371. EvaWare UK
  372. No 5 Grosvenor Court
  373. Louth
  374. Lincolnshire LN11 9LT
  375. ENGLAND
  376.  
  377. When your registration form is received we will despatch
  378. a Key file and the latest version of the product on
  379. diskette to you.
  380.  
  381. Being honest and registering this product will help me to
  382. be able to afford development of the next version.
  383.  
  384.  
  385.  
  386. Contacting the Author
  387. I can be contacted obviously by post to the address shown
  388. above but I shall be maintaining a presence in the
  389. OFFLINE and SHWARE conferences of ILINK. I can also be
  390. contacted at USENET E-Mail address nick.dyer@almac.co.uk
  391.  
  392. I would very much like to hear your comments about the
  393. package as user feedback will enable me to know what
  394. areas are most important to the average user.
  395.  
  396.  
  397.  
  398.  
  399. Thanks For Help
  400. Have to go foremost to ALMAC in Scotland for such a great
  401. board whose telephone number by the way is Int +44 (0)324
  402. 665371. They put up with me uploading various spurious
  403. messages whilst testing was going on and not to mention
  404. pointed me in the right direction with regard to major
  405. requirements of a mail reader. So Thanks Guys!!!
  406.  
  407. Thanks also have to go to Michael Stewart in the
  408. Win.App.Dev conference on Ilink for helping me with a
  409. routine to convert 4 byte Basic Real to long numbers.
  410. Thanks Michael!
  411.  
  412. Thanks also to my wife Anette for putting up with my long
  413. hours of absence from the family home during this time of
  414. development.
  415.  
  416. And finally.. thanks to you for downloading this product.
  417.  
  418.  
  419.  
  420. Copyrights and trademarks.
  421.  
  422.  
  423.      Orator         Nick Dyer EvaWare UK
  424.      Qmail               Sparkware.
  425.      MarkMail       Mark  Turner.
  426.      TomCat         Greg Hewgill.
  427.      RAMail         Randy Blackmond.
  428.      PKZip/PKUnzip  Phil Katz.
  429.      ARC            System Enhancement Associates.
  430.      PAK            NoGate Consulting.
  431.      Zoo            Rahul Dhesi.
  432.      Lha/Lharc      Haruyasu Yoshizaki.
  433.      MS-DOS         Microsoft Corporation.
  434.      MicroSoft Windows   Microsoft Corporation.
  435.  
  436.  
  437.